혼자 공부하는 바이브 코딩 — 5장 게임 제작으로 배우는 체계적인 개발과 관리 딥다이브 학습 노트

출처: 혼자 공부하는 바이브 코딩 with 클로드 코드 (조태호) | 참고: https://github.com/taehojo/vibecoding

5장에서 다루는 내용

• 할루시네이션 없는 AI 콘텐츠 만들기 — 퀴즈 게임 구현 + AI 할루시네이션 해결
• 자동화로 개발 효율 높이기 — 게임 확장, 커스텀 명령어, 반복 작업 자동화
• 명령어 체이닝을 통한 유지보수 전략 — &&로 명령어 연결, 통합 커스텀 명령어, 선생님 모드

전체 흐름도

[05-1 퀴즈 게임 구현]        [05-2 자동화]              [05-3 유지보수 전략]
    |                        |                          |
    v                        v                          v
+------------------+   +-------------------+   +------------------------+
| 상식 퀴즈 게임     |   | 게임 확장           |   | 커스텀 명령어 생성       |
| 구현하기          |   | • 순위 시스템        |   | • /quiz-check          |
|                  |   | • 새 퀴즈 자동 추가  |   | • /quiz-leaderboard    |
| 할루시네이션 발견   |   |                   |   | • /quiz-stats          |
| → 해결 방법 3가지  |   | 커스텀 명령어로      |   |                        |
| • 출처 명시       |   | 반복 작업 자동화    |   | 명령어 체이닝 (&&)         |
| • 검증 요청       |   |                   |   | 통합 커스텀 명령어          |
| • 팩트체크 프롬프트|   |                   |   | /quiz-daily            |
+------------------+   +-------------------+   |                        |
                                                | 선생님 모드              |
                                                | /teacher-dashboard    |
                                                | AI가 스스로 명령어 설계 |
                                                +------------------------+

선수 지식 체크리스트

• [ ] 4장: 단계별 프롬프트, 클로드 코드 명령어 (/init, /status 등)
• [ ] 클로드 코드 기본 사용법 (파일 생성, 실행)
• [ ] localStorage 개념 (브라우저 데이터 저장)

핵심 키워드

05-1 할루시네이션 없는 AI 콘텐츠 만들기

한 줄 요약

상식 퀴즈 게임을 만들면서 AI 할루시네이션 문제를 발견하고 3가지 해결 방법을 익힌다.

쉬운 설명 (시험 출제 비유)

"선생님이 시험 문제를 만들 때, 정답이 맞는지 교과서로 확인하는 것처럼, AI가 만든 퀴즈도 반드시 팩트체크를 해야 한다. AI는 자신감 있게 틀린 답을 말할 수 있기 때문이다."

실습: 상식 퀴즈 게임 구현

프롬프트:
"상식 퀴즈 게임을 만들어 줘. 4지선다 형식으로 10문제를 풀 수 있는
 웹 기반 퀴즈 앱을 만들어 줘."

→ 클로드 코드가 HTML/CSS/JS로 퀴즈 앱 생성
→ 카테고리별 문제, 점수 시스템, 결과 화면 포함

AI 할루시네이션이란?

문제: AI가 퀴즈 문제를 만들면서 사실이 아닌 정보를 그럴듯하게 생성

예시:
Q: "한국 최초의 우주인은?"
AI가 만든 답: "이소연 (2008년)" → 맞음 ✅
AI가 만든 답: "김우주 (2005년)" → 틀림 ❌ (존재하지 않는 사람!)

→ AI가 자신감 있게 잘못된 정보를 제시하는 것이 할루시네이션

할루시네이션 해결 방법 3가지

방법 1: 출처 명시 요청
──────────────────
프롬프트: "각 문제의 출처나 근거를 함께 제공해 줘."
→ AI가 출처를 찾으려 하면 정확도가 높아짐

방법 2: 검증 단계 추가
──────────────────
프롬프트: "생성한 문제의 정답이 실제로 맞는지 검증해 줘."
→ AI가 스스로 팩트체크를 수행

방법 3: 팩트체크 프롬프트
──────────────────
프롬프트: "이 퀴즈의 모든 문제와 정답을 검증해 줘.
  - 모든 문제의 구조적 검증
  - 정답 정확성 확인
  - 설명의 적절성 검토
  - 의심스러운 문제 식별
  - 오류 발견 시 즉시 보고"
→ 체계적인 검증 프로세스 실행

핵심 체크포인트

• ✅ AI 할루시네이션 = AI가 사실이 아닌 정보를 그럴듯하게 생성하는 현상
• ✅ 해결: 출처 요청, 검증 단계 추가, 팩트체크 프롬프트
• ✅ AI가 생성한 콘텐츠는 항상 검증해야 한다

05-2 자동화로 개발 효율 높이기

한 줄 요약

퀴즈 게임을 확장하고, 커스텀 명령어로 반복 작업을 자동화한다.

게임 확장

확장 기능:
- 데이터 저장 및 순위 시스템 (리더보드)
- 게임 제작 워크플로 자동화
- 새로운 퀴즈 문제 자동 추가 기능

커스텀 명령어 만들기

커스텀 명령어란?
= .claude/commands/ 폴더에 .md 파일로 저장되는 사용자 정의 슬래시 명령어

생성 방법:
프롬프트로 "퀴즈 문제의 정답을 검증하는 커스텀 명령어를 만들어 줘"
→ .claude/commands/quiz-check.md 파일 생성
→ /quiz-check 명령어로 실행 가능!

생성된 커스텀 명령어 예시:
/quiz-check      — 문제 정답 검증
/quiz-leaderboard — 순위 시스템 관리
/quiz-stats       — 통계 분석

새로운 퀴즈 문제 자동 추가

프롬프트:
"/quiz-add 한국사 상급"
→ '한국사' 카테고리에 상급 난이도 퀴즈를 추가
→ /quiz-check 명령어로 정답 검증까지 자동 실행

핵심 체크포인트

• ✅ 커스텀 명령어 = .claude/commands/ 폴더의 .md 파일
• ✅ /quiz-add, /quiz-check 등 프로젝트에 특화된 명령어 생성 가능
• ✅ 반복 작업(문제 추가 → 검증 → 통계)을 자동화

05-3 명령어 체이닝을 통한 유지보수 전략

한 줄 요약

&& 연산자로 명령어를 체이닝하고, 통합 커스텀 명령어와 선생님 모드를 구축한다.

명령어 체이닝 (&&)

여러 커스텀 명령어를 순서대로 실행:

> /quiz-add 한국사 상급 && /quiz-check && /quiz-stats

실행 순서:
1. /quiz-add: 한국사 상급 문제 추가
2. /quiz-check: 정답 검증
3. /quiz-stats: 통계 분석

핵심: && 연산자는 이전 명령이 성공해야 다음 명령을 실행
→ 첫 번째 명령이 실패하면 두 번째 명령은 실행되지 않음

통합 커스텀 명령어 (/quiz-daily)

매일 해야 하는 작업을 하나의 명령어로:

/quiz-daily 실행 시:
1. 퀴즈 데이터 구조 파악
2. 문항 수와 분포 확인
3. 카테고리별 결손 파악
4. 추가 전 중복 체크
5. 새 문제 생성 후 형식 검증
6. 전체 데이터 백업
7. 결과 리포트 출력

→ 7단계 파이프라인을 매일 한 번에 실행!
각 단계마다 검증하므로 실패 시 즉시 중단 → 오류 보고

선생님 모드 (AI가 스스로 명령어 설계)

프롬프트:
"여러 학생들의 성적을 한눈에 보고 비교하는 선생님 모드를 만들고 싶어.
 이 기능에 필요한 커스텀 명령들을 직접 구상하고 만들어 줘.
 그리고 이 명령어를 하나로 모아서 실행하는 통합 명령어도 만들어 줘.
 모든 명령들은 '.claude/commands/' 폴더 안에 각각 .md 확장자로 저장되어야 해."

→ AI가 스스로 필요한 명령어를 판단하고 생성:
  /teacher-dashboard — 통합 대시보드 (권장)
  /teacher-leaderboard — 학생 순위 리더보드

결과: 퀴즈 성적 종합 보고서
  - 전체 학생 수: 20명
  - 평균 점수: 64.8점
  - 최고 점수: 79점, 최저 점수: 50점
  - 우수 학생 (상위 5명) 리더보드
  - CSV 파일로 내보내기 가능

효율적인 유지보수 워크플로

커스텀 명령어의 유지보수 장점:

1. 모듈화: 각 기능이 독립된 .md 파일로 관리
   → 필요한 부분만 선택적으로 수정 가능
   → 전체 구조는 그대로 유지

2. 기존 명령어 업데이트:
   프롬프트: ".claude/commands/create-report.md를 수정해 줘.
   등급을 상위 비율 기준 상대평가로 변경해서 표시되게 해."
   → 해당 .md 파일만 수정하면 명령어 동작이 바뀜

3. 새 기능 확장:
   프롬프트: ".claude/commands/export-report.md 파일을 새로 만들어 줘."
   → 기존 통합 명령어에 추가만 하면 확장 완료

핵심 체크포인트

• ✅ && 연산자로 명령어를 체이닝하여 순차 실행 (실패 시 중단)
• ✅ 통합 커스텀 명령어로 7단계 파이프라인을 매일 한 번에 실행
• ✅ AI가 스스로 필요한 커스텀 명령어를 판단하고 생성 가능 (선생님 모드)
• ✅ .md 파일 단위로 모듈화하면 유지보수가 용이

연습문제 풀이

Q1: && 연산자로 연결된 명령어는 순차적으로 실행된다. 첫 번째 명령이 실패하면?

A: 두 번째 명령은 실행되지 않는다. && 연산자는 이전 명령이 성공해야 다음 명령을 실행하는 조건부 순차 실행이다.

Q2: 커스텀 명령어는 어떤 형식의 파일로 저장되는가?

A: .md (마크다운) 파일로 저장된다. .claude/commands/ 폴더 안에 각각의 .md 파일로 저장되어 /명령어이름 으로 실행한다.

Q3: 두 명령어를 연결하여 순차 실행하려면 어떤 연산자를 사용하는가?

A: && 연산자를 사용한다. 예: /quiz-add 한국사 상급 && /quiz-check

부록 A: 용어 사전

부록 B: 핵심 비교표

커스텀 명령어 활용 단계

부록 C: 추천 참고 자료 & 링크